Skip to content

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Jan 27, 2026

What

Fixes incorrect field names in the hosted agent connectors tutorial. The API expects environment for connector-specific configurations (like repositories for GitHub) and credentials for authentication, but the documentation showed source_config, causing 422 errors for users following the tutorial.

How

Updated the field names and descriptions in docs/ai-agents/quickstarts/tutorial-hosted.md:

  • Changed source_config to environment in the example curl request
  • Removed the outdated source_config field description
  • Simplified field descriptions to just credentials and environment

Review guide

  1. docs/ai-agents/quickstarts/tutorial-hosted.md - verify the field names match the actual API schema for /api/v1/integrations/connectors

Human review checklist

  • Confirm environment is the correct field for GitHub's repositories config
  • Consider testing the curl example against the actual API

User Impact

Users following this tutorial will now be able to successfully create connectors without receiving 422 validation errors.

Can this PR be safely reverted and rolled back?

  • YES 💚

Requested by: ian-at-airbyte
Link to Devin run: https://app.devin.ai/sessions/aa62f13a945a42458b067a9c2c7ffbc5

Important

Auto-merge enabled.

This PR is set to merge automatically when all requirements are met.

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@devin-ai-integration
Copy link
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Contributor

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

  • 🛠️ Quick Fixes
    • /format-fix - Fixes most formatting issues.
    • /bump-version - Bumps connector versions, scraping changelog description from the PR title.
  • ❇️ AI Testing and Review:
    • /ai-docs-review - Provides AI-powered documentation recommendations for PRs with connector changes.
    • /ai-prove-fix - Runs prerelease readiness checks, including testing against customer connections.
    • /ai-canary-prerelease - Rolls out prerelease to 5-10 connections for canary testing.
    • /ai-review - AI-powered PR review for connector safety and quality gates.
  • 🚀 Connector Releases:
    • /publish-connectors-prerelease - Publishes pre-release connector builds (tagged as {version}-preview.{git-sha}) for all modified connectors in the PR.
    • /bump-progressive-rollout-version - Bumps connector version with an RC suffix (2.16.10-rc.1) for progressive rollouts (enableProgressiveRollout: true).
      • Example: /bump-progressive-rollout-version changelog="Add new feature for progressive rollout"
  • ☕️ JVM connectors:
    • /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
      Example: /update-connector-cdk-version connector=destination-bigquery
    • /bump-bulk-cdk-version bump=patch changelog='foo' - Bump the Bulk CDK's version. bump can be major/minor/patch.
  • 🐍 Python connectors:
    • /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
    • /poe source example lock - Alias for /poe connector source-example lock.
    • /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
    • /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.
  • ⚙️ Admin commands:
    • /force-merge reason="<REASON>" - Force merges the PR using admin privileges, bypassing CI checks. Requires a reason.
      Example: /force-merge reason="CI is flaky, tests pass locally"
📚 Show Repo Guidance

Helpful Resources

📝 Edit this welcome message.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 27, 2026

Deploy preview for airbyte-docs ready!

✅ Preview
https://airbyte-docs-2cwdcx744-airbyte-growth.vercel.app

Built with commit d8996d8.
This pull request is being automatically deployed with vercel-action

…r config

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@devin-ai-integration devin-ai-integration bot changed the title docs: update source_config to replication_config in hosted tutorial docs: fix connector config field names in hosted tutorial Jan 27, 2026
- `environment`: Connector-specific configurations for replication connectors.
- `environment`: Connector-specific configurations for the connector.

- `replication_config`: Optional replication-specific settings like `start_date`, `lookback_window`, etc.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can omit this line, since this connector doesn't use it.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done - removed the replication_config line.

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@ian-at-airbyte ian-at-airbyte marked this pull request as ready for review January 28, 2026 00:20
@ian-at-airbyte ian-at-airbyte enabled auto-merge (squash) January 28, 2026 00:21
@ian-at-airbyte ian-at-airbyte merged commit 6ccad03 into master Jan 28, 2026
50 checks passed
@ian-at-airbyte ian-at-airbyte deleted the devin/1769553424-fix-source-config-docs branch January 28, 2026 01:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant